home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Gold Medal Software 4
/
Gold Medal Software - Volume 4 (Gold Medal) (1994).iso
/
netutils
/
brir110e.arj
/
DOC.ZIP
/
INTRO.TXT
< prev
next >
Wrap
Text File
|
1994-06-29
|
115KB
|
2,661 lines
BrightWorks Version 1.1
Copyright 1994 by McAfee, Inc.
All Rights Reserved.
Copyright 1994 by McAfee, Inc. All rights reserved. McAfee is a
registered trademark of McAfee, Inc. BrightWorks, SiteMeter,
LAN Inventory, NetShield, NetRemote, and LAN Support Center
are trademarks of McAfee, Inc. All other products or
services mentioned in this document are identified by the trademarks
or service marks of their respective companies or organizations.
McAfee, Inc.
2710 Walsh Avenue
Santa Clara, CA 95051-0963
U.S.A.
Technical Support Information
-----------------------------
Phone (908) 530-9650
FAX (908) 576-8867
Hours 9 a.m. to 7 p.m. EST
McAfee BBS (408) 988-4004
1200 bps to 14,400 bps
8 bits, no parity, 1 stop bit
24 hours, 365 days a year
Compuserve GO MCAFEE
Internet customer_service@brightwork.com
If you are not a customer located in the U.S. or Canada, you can
contact a McAfee authorized agent. Agents are located in more than
50 countries aroudn the world and provide local sales and support
for our software. Please refer to the AGENTS.TXT file for a complete
list of McAfee agents.
BrightWorks consists of three major functional components:
o Software Metering
o Inventory Collection and Auditing
o Software Distribution
If you purchased... Then refer to...
BrightWorks Intro.txt for an introduction to BrightWorks,
installation instructions, console usage
instructions, and tutorials
Metering.txt for complete usage instructions
for the metering capability
Inventry.txt for complete usage instructions
for the inventory capability
Distrib.txt for complete usage instructions
for the software distribution capability
Crystal.txt for complete usage instructions on
Crystal Reports
Ref.txt for error messages and other
reference information
SiteMeter Chapter 2 of Intro.txt for installation
instructions
Chapter 3 of Intro.txt for console usage
instructions
Chapter 4 of Intro.txt for tutorial
Metering.txt for complete usage instructions
Crystal.txt for complete usage instructions on
Crystal Reports
Ref.txt for error messages and other
reference information
LAN Inventory Chapter 2 of Intro.txt for installation
instructions
Chapter 3 of Intro.txt for console usage
instructions
Chapter 4 of Intro.txt for tutorial
Inventry.txt for complete usage instructions
Crystal.txt for complete usage instructions
on Crystal Reports
Ref.txt for error messages and other
reference materials
List of Topics
1.0 Introduction
1.1 About BrightWorks
1.1 The Problem
1.1.2 The McAfee Solution
1.2 BrightWorks' Features
1.2.1 Software Metering
1.2.2 Asset Management
1.2.3 Software Distribution
1.3 BrightWorks' Economic Benefits
1.4 BrightWorks' Major Capabilities
1.5 Environment
1.6 SMRPROXY.NLM Requirements
1.7 How This Manual Is Organized
2.0 BrightWorks Installation
2.1 Before Installation
2.1.1 Determining Version Numbers
2.2 BrightWorks Installation Instructions
2.3 Basic Install
2.4 Custom Install
2.5 Upgrade Procedures
2.6 Installing NLMs
2.7 Troubleshooting
3.0 Getting Started
3.1 Introduction
3.2 The BrightWorks Console
3.2.1 Windows Terms
3.2.2 Accessing BrightWorks
3.2.3 Exiting BrightWorks
3.2.4 BrightWorks Menu Bar
3.2.5 BrightWorks Tool Bar
3.2.6 Using the Keyboard
3.2.7 BrightWorks' Help Facility
3.2.8 The .INI File
3.3 Printer Setup and Administration
3.4 Error Handling
4.0 Tutorials
4.1 Metering Tutorial
4.1.1 Creating a Metered Application
4.1.2 Viewing Application Usage
4.1.3 Creating an Authorized File
4.1.4 Specifying the File Scan Interval
4.2 Inventory Tutorial
4.2.1 Collecting Inventory Data
4.2.2 Configuring the Audit Parameters
4.2.3 Running the Audit
4.2.4 Viewing Audit Results
4.3 Distribution Tutorial
4.3.1 Creating and Compiling a Script
4.3.2 Creating a Scope
4.3.3 Scheduling a Package
4.3.4 Running the Update Program
1.0 Introduction
Welcome to BrightWorks, the easy-to-use, integrated software management
solution from the network utilities experts.
BrightWorks is a member of McAfee's family of intuitive LAN support tools,
a group of network applications all designed to reduce the cost of LAN
ownership.
NOTE: This chapter pertains to BrightWorks, SiteMeter and LAN Inventory.
1.1 About BrightWorks
BrightWorks empowers network administrators with the tools necessary to
manage network software effectively. By offering software metering, asset
management and software distribution capabilities, BrightWorks increases
the effectiveness of your LAN support efforts.
BrightWorks' modular design enables network administrators to structure the
solution that best fits their network management needs. In addition to
offering three integrated functions, BrightWorks also allows access to other
McAfee management solutions. And BrightWorks' open framework facilitates
integration with many management systems and products.
McAfee has the networking experience to deliver an integrated solution
as comprehensive and valuable as BrightWorks.
NOTE: This manual accompanies BrightWorks, SiteMeter and LAN Inventory
products. Refer to the chart below to determine which chapters in this
manual apply to your purchase.
CAPABILITY AVAILABLE IN... CHAPTERS
Metering BrightWorks & SiteMeter 1-11
Inventory BrightWorks & LAN Inventory 1-4 & 12-18
Distribution BrightWorks 1-4 & 19-25
1.1 The Problem
As LAN technology expands, networks grow rapidly and users demand additional
capabilities. With this growth comes expanded network software support
issues. Software license compliance, driver updates, software upgrades,
hardware purchases, and network security are but a few of the network
software issues in question. Dealing with all of these issues dramatically
increases the network administrator's workload. Unfortunately, even as
networks grow and the number of users continues to expand, the number of
skilled network administrators typically remains constant.
In addressing these issues, network administrators are raising questions
such as:
o How do I keep network support from becoming an overwhelming task?
o How do I make changes to files on large numbers of workstations quickly
and without downtime?
o How can I maintain crucial network security as the network continues
to expand?
Clearly, for network administrators, intelligent network software management
is mission critical!
1.1.2 The McAfee Solution
The solution to these problems is BrightWorks! By offering integrated
software management capabilities for networks, BrightWorks performs:
o Software usage tracking and license enforcement
o Asset inventory of hardware, software, and system configuration files
o Software and data distribution
o Software security
o Management reporting
With these software management tools, network administrators can maximize
resource productivity:
o Effective allocation of resources, software and hardware, based on
actual usage
o Increased support effectiveness enabled by active configurations
o Accurate software purchasing based on actual usage
BrightWorks' flexibility lets you tailor network management to your specific
needs.
1.2 BrightWorks' Features
BrightWorks is packed with features that aid you in managing your network.
The following lists the features available with each of BrightWorks' main
capabilities:
1.2.1 Software Metering
o Flexible metering methods to give you a choice between NLM and TSR-based
metering
o Easy and simple installation of the metering methods to decrease
administrative burden
o Option to prevent users from using local drives with an optional
2workstation TSR to help you maintain network integrity
o Real time trustee rights granting tied to application usage (masking)
to control access to sensitive or critical network applications
o Metering for DOS and Windows programs to ensure compliance with
software license agreements
o Graphical display of software usage to help you make purchase decisions
o Queue back for metered applications to ensure license compliance
and maximize the effectiveness of available resources
o Suite metering for accurate enforcement of concurrent license agreements
for suite applications, such as Microsoft Office
o Virus protection to prevent costly downtime due to corrupted files
1.2.2 Asset Management
o Recording and detecting of changes in software and hardware configurations
(file servers, PCs & Macs) to eliminate the need for manual inventory
o Inventorying for multiple sites to maximize resource usage
o Alerting of changes in software and hardware configurations via cc:Mail,
MHS, e-mail and paging notification to enable timely network support and
provide an added level of security
o Auto-learning of new software to reduce the time required to input new
applications
o Detailed vendor and warranty data tracking to keep records up-to-date
and to inform purchase decisions
o Inventory information import and export capabilities to preserve
compatibility with other products and databases
1.2.3 Software Distribution
o Automated distribution of system files, data files and software
applications to eliminate "sneaker-net" for these functions
o Flexible and powerful scripting language that allows you to customize
distribution of system files, data files and software applications
o Ability to edit system files (e.g., CONFIG.SYS, AUTOEXEC.BAT) to enable
global replacement and workstation-specific changes without visiting
each workstation
1.3 BrightWorks' Economic Benefits
Using structured software management results in the following economic
benefits:
1. Reduce user support costs by
o reducing the time required to troubleshoot user and network problems
with an accurate, up-to-date hardware and software inventory,
o minimizing potential software incompatibilities by preventing
unauthorized software from running,
o allocating training dollars to minimize support calls with detailed
application usage reports by user, department or application, and
o reducing downtime by pinpointing outdated equipment and drivers
quickly and easily.
2. Reduce network maintenance costs by
o minimizing incompatibilities from non-standard configurations or tampering
users by standardizing and centrally enforcing PC software configurations,
o eliminating the need to walk from PC to PC to update workstation software
configurations (i.e., network drivers, versions of DOS, CONFIG.SYS,
AUTOEXEC.BAT, etc.),
o eliminating the need to walk from PC to PC to get an accurate hardware
and software inventory,
o minimizing downtime for users with automatic detection and reporting of
changes to network hardware and software configurations,
o minimizing theft by automatically detecting missing hardware,
o eliminating wasted time spent trying to determine what equipment and
software requires upgrades,
o configuring new workstations identically to others in an automated fashion
with pre-configured distribution packages, and
o recovering quickly from individual PC hard drive disaster by automating
the distribution of a new configuration based on records of previous
distributions.
3. Cut software and hardware purchase costs by
o purchasing software based on actual simultaneous usage rather than on
counting the number of workstations attached to the network,
o purchasing software upgrades based on actual simultaneous usage rather
than on the number of packages owned, and
o using detailed management reports to allocate workstation equipment
based on actual usage (e.g., supplying a power user with a 486 and a mail
user with a 386).
4. Enforce software license compliance by
o ensuring compliance with corporate and SPA guidelines, and
o proving software compliance with SPA-approved reports.
All of these benefits result in significant time and money savings!
1.4 BrightWorks' Major Capabilities
BrightWorks consists of three major functional components:
o Software Metering
o Inventory Collection and Auditing
o Software Distribution
In addition to these capabilities, you can also access other McAfee
management solutions from the BrightWorks console by choosing the
appropriate tool bar button.
If you wish to access McAfee's NETremote+ from BrightWorks, choose the
Remote tool bar button and then refer to your NETremote+ manual for usage
instructions.
If you wish to access McAfee's LAN Support Center from BrightWorks, choose
the Tickets tool bar button and then refer to your LAN Support Center
manual for usage instructions.
NOTE: Refer to Chapter 34 for instructions on enabling BrightWorks
smart-launch within NMS.
1.5 Environment
The following criteria must be met in order to run each BrightWorks
capability:
Brightworks:
o Network Operating System: Novell NetWare 2.x, 3.x
o Network Disk Space: 13 MB required, 25 MB recommended
o Btrieve Database Access: server based: BTRIEVE.NLM
o Operating System: DOS 3.3 or greater
o User Interface: Microsoft Windows 3.1 in enhanced mode
o Btrieve Datbase Access: server based: BREQUEST.EXE 6.1 or greater;
local based: BTRIEVE.EXE
o CPU: 386SX or higher
o RAM: 4 MB
o Disk Space: 12 MB & 50K per workstation
o Monitor: VGA or better
o Workstation RAM: minimum of 640K
o Workstation CPU: 386 or greater
SiteMeter:
o Network Operating System: Novell NetWare 2.x, 3.x
o Network Disk Space: 13 MB required, 25 MB recommended
o Operating System: DOS 3.3 or greater
o User Interface: Microsoft Windows 3.1 in enhanced mode
o Btrieve Database Access: server based: BREQUEST.EXE 6.1 or greater;
local based: BTRIEVE.EXE
o CPU: 386SX or higher
o RAM: 2 MB
o Disk Space: 5 MB
o Monitor: VGA or better
o Workstation RAM: minimum of 640K
o Workstation CPU: 286 or greater
o To restrict access to local drives: SWATCHER.COM TSR 5K
LAN Inventory:
o Network Operating System: Novell NetWare 2.x, 3.x, 4.0
o Network Disk Space: 13 MB required, 25 MB recommended
o Btrieve Database Access: server based: BTRIEVE.NLM
o Operating System: DOS 3.3 or greater
o User Interface: Microsoft Windows 3.1 in enhanced mode
o Btrieve Datbase Access: server based: BREQUEST.EXE 6.1 or greater;
local based: BTRIEVE.EXE
o CPU: 386SX or higher
o RAM: 2 MB
o Disk Space: 6 MB
o Monitor: VGA or better
o Workstation RAM: minimum of 640K
o Workstation CPU: 386 or greater
NOTES: a - BrightWorks operates on Novell NetWare via IPX/SPX and is
compatible with NetWare 4.0 and NMS. Refer to Chapter 34.0 for instructions
on enabling BrightWorks smart-launch within NMS.
b - BrightWorks includes multi-user BTRIEVE 5.10a.
c - BrightWorks' inventory capability will work with Client Based and
Server Based Btrieve. Server Based Btrieve is recommended for increased
performance. When using BREQUEST, version 6.10c or greater is required.
Refer to Chapter 32.0 for more information on using BREQUEST.
d - Verify that you are running the latest versions of the Btrieve files.
Updated Btrieve files can be found on Compuserve in the Novell Libraries
(GO NOVLIB).
1.5 SMRPROXY Requirements
This section describes the requirements for the SMRPROXY.NLM.
Requirements for NetWare v. 3.11 fileserver:
The new SMRPROXY.NLM which ships with SiteMeter v. 4.2 (and BrightWorks v.
1.1) is 'LSL based'. That means that to successfully run the SMRPROXY.NLM on
NetWare v. 3.11, you must load the LSLENH.NLM on the fileserver. The
LSLENH.NLM requires that the PATCHMAN.NLM and the latest LAN drivers (.LAN)
be loaded on the fileserver. The latest .LAN drivers require ETHERTSM.NLM
to be loaded on the fileserver (ETHERTSM is loaded for Ethernet network
topologies. If the customer has a token ring network topology then
TOKENTSM.NLM would be loaded instead of the ETHERTSM.NLM. Likewise,
FDDITSM.NLM, RXNETTSM.NLM and PCN2LTSM.NLM are available for their
respective topologies). The ETHERTSM.NLM requires the MSM.NLM to be loaded.
Additionally, CLIB.NLM revision 3.12F or later must be loaded.
In short, the following new files are needed:
o CLIB.NLM v. 3.12f
o MSM.NLM v. 2.2
o LSLENH.NLM v. 1.01
o PATCHMAN.NLM v. 2.3
o ETHERTSM.NLM, or TOKENTSM.NLM or RXNETTSM.NLM (this depends on the
Topology used)
All LAN drivers need to be updated (i.e. NE2000.LAN).
Here is an example AUTOEXEC.NCF file which shows which NLMs need to be
loaded :
file server name vanwinkle
ipx internal net cafe
LOAD LSLENH <-- automatically loads PATCHMAN.NLM.
LOAD NE2000 PORT=340 INT=5 <-- automatically loads MSM.NLM and
[ETHER]TSM.NLM.
bind IPX to NE2000 net=10
set allow unencrypted passwords = on
NOTE: ETHERTSM.NLM is shown in brackets to emphasize that a different
'TSM.NLM' would be automatically loaded by NetWare for a different topology.
The topology in this example is Ethernet as indicated by the NE2000.LAN
driver which is being loaded.
CLIB.NLM v. 3.12F is available on Compuserve in a self-extracting compressed
file. Have the customer log on to Compuserve, GO NOVLIB, LIB 4 and download
LIBUP2.EXE. The rest of the required files are available in a
self-extracting compressed file called LANDR3.EXE which is also located on
Compuserve. To get LANDR3.EXE, simply GO NOVFILES and then download the file.
LANDR3.EXE 233,440 05-18-94 3:13p
Use the following procedure to update the fileserver.
1. Copy CLIB.NLM v. 3.12F into the SYS:SYSTEM directory.
2. Copy LANDR3.EXE into the SYS:SYSTEM directory.
3. Execute LANDR3.EXE in the SYS:SYSTEM directory. Make sure that any
older files are not marked 'Read Only' so they are overwritten by the
new files.
4. Please refer to the STATS.DOC document for further information on the new
files and/or special conditions (this file now resides in your
SYS:SYSTEM directory).
5. At the fileserver Console ':' prompt, type Load Install.
6. Select 'Edit Autoexec.ncf'.
7. A line needs to be added prior to the load line of the LAN board (please
see the example autoexec.ncf file above).
The line is LOAD LSLENH.
8. Down the server and bring the server back up.
9. Verify that all the required files were loaded on the fileserver (do this
by typing Modules at the fileserver console).
The following files are contained in LANDR3.EXE:
o STATS DOC 63446 10-06-93 3:55p
o TOKENTSM NLM 9040 09-30-93 3:30p
o MSM NLM 15628 10-04-93 1:03p
o FDDITSM NLM 7847 07-07-93 5:07p
o MSM31X NLM 16483 10-04-93 1:04p
o PATCHMAN NLM 9632 02-04-93 10:38a
o NE2 LAN 4954 10-08-93 10:44a
o NE2_32 LAN 5066 05-12-93 4:03p
o NE2100 LAN 7224 09-24-93 4:25p
o TOKEN LAN 10125 06-07-93 1:29p
o NE3200 LAN 13811 10-08-93 10:51a
o LANDR3 TXT 26051 10-27-93 2:12p
o RXNETTSM NLM 6202 01-06-93 10:04a
o PCN2LTSM NLM 5691 01-30-93 11:32a
o NE1000 LAN 4468 01-20-93 3:18p
o !NVL1301 CFG 1169 03-12-92 2:28p
o !NVL1401 CFG 986 06-10-92 4:02p
o !NVL1501 CFG 11994 01-11-93 3:24p
o !NVL0901 CFG 8293 10-04-90 10:42a
o FIRMLOAD COM 1628 01-04-91 8:57a
o @7154 ADF 2657 04-27-92 1:54p
o XLOAD EXE 13872 08-06-91 4:47p
o XLOAD DOC 3472 07-06-92 11:00a
o LDR001 PTF 52920 11-06-91 4:55p
o LDR001 DOC 3200 07-06-92 11:00a
o NE2000 LAN 7356 10-08-93 10:47a
o NE1500T LAN 7226 09-24-93 4:25p
o TOKENDMA LAN 10861 05-26-93 3:16p
o ETHERTSM NLM 8841 09-28-93 2:41p
o NTR2000 LAN 10272 09-13-93 2:23p
o PM311IO NLM 8384 04-13-93 11:28a
o LSLENH3 NLM 10500 06-02-93 11:34a
o IOSHIM NLM 1649 06-09-93 9:50a
o TRXNET LAN 3075 01-07-93 1:23p
o PCN2L LAN 4726 01-29-93 8:45p
o LSLENH NLM 11641 11-16-92 8:29a
o MONITOR NLM 117775 10-26-92 9:21a
o !NVL1201 CFG 7378 03-26-92 9:08a
o NE32HUB LAN 12266 01-27-93 9:11a
o @7151 ADF 2346 07-26-89 5:08p
o !NVL0701 CFG 2745 09-02-92 1:25p
41 file(s)
Requirements for NetWare v. 3.12 fileserver
The only new file required for NetWare v. 3.12 is CLIB.NLM v. 3.12F or later.
Use the following procedure to update the fileserver.
1. Copy CLIB.NLM v. 3.12F into the SYS:SYSTEM directory.
2. Down the fileserver and bring the fileserver back up.
3. Verify that the new version of CLIB.NLM was loaded on the server (do
this by typing Modules at the fileserver Console).
Requirements for NetWare v. 4.X fileserver
The requirements for NetWare v. 4.X is that the customer be running
NetWare v. 4.01 or later, 250 user version or lower, with bindery emulation.
NOTES:
a - SiteMeter operates on Novell NetWare via IPX/SPX. Refer to Appendix E
for instructions on enabling SiteMeter smart-launch within NMS.
b - SiteMeter includes multi-user BTRIEVE 5.10a.
c - Verify that you are running the latest versions of the Btrieve files.
Updated Btrieve files can be found on Compuserve in the Novell Libraries (GO
NOVLIB).
1.7 How This Manual Is Organized
The following lists the contents of each part of this manual:
o Intro.txt: Introduction, Chapters 1-4: Background information, environment
requirements, technical support information, installation instructions,
console description, and tutorials for each capability.
o Metering.txt: Metering, Chapters 5-11: Complete instructions for using the
metering capability.
o Inventry.txt: Inventory, Chapters 12-18: Complete instructions for using
the inventory capability.
o Distrib.txt: Software Distribution, Chapters 19-25: Complete instructions
for using the software distribution capability.
o Crystal.txt: Crystal Reports, Chapters 26-28: Complete instructions for
using the Crystal Reports software included with the BrightWorks product.
o Ref.txt: Reference, Chapters 29-34: Appendices regarding BrightWorks
error messages, BrightWorks file lists, inventory equipment database,
Brequest, Btrieve return status codes and BrightWorks' smart-launch
within NMS.
2.0 BrightWorks Installation
Chapter 1 introduced BrightWorks. This chapter describes the installation
procedures for BrightWorks and also provides an installation
troubleshooting section.
NOTES: a - This chapter pertains to BrightWorks, SiteMeter and LAN Inventory.
b - Unzip the program files from the BBS into a directory on your local or
network drive.
2.1 Before Installation
To install BrightWorks, you must:
o Be logged in to the network as a SUPERVISOR or equivalent
o Run Windows 3.1 in enhanced mode
o Have the following line in the [386Enh] section of your SYSTEM.INI file:
network=*vnetbios, vnetware.386, vipx.386
o Have a drive mapped to your system volume
The following file versions are recommended for BrightWorks' installation
and use:
o IPX version 3.10
o NETX version 3.26 or greater
o Windows version 3.1 (enhanced mode)
o VIPX version 1.13
o NETWARE.DRV version 2.02
o VNETWARE.386 version 1.06
NOTE: If you are using ODI drivers instead of IPX, you must have the
following:
- LSL version 2.01
- IPXODI.COM version 2.1
The latest versions of these files can be found on Compuserve in the
Novell Libraries (GO NOVLIB). As of this writing, the current IPX, NETX,
and IPXODI are contained within the self-extracting file named DOSUP9.EXE.
The current versions of the Novell support drivers for Windows (VIPX.386,
VNETWARE.386, NETWARE.DRV, etc.) can be found in the self-extracting file
WINUP9.EXE.
NOTE: As these drivers are updated and added to the Compuserve file, the
number within the Compuserve filename will increment. For example, if
Novell were to release a newer IPX and add it to DOSUP9.EXE, the name would
change to DOSUP10.EXE.
2.1.1 Determining Version Numbers
You can determine the versions of the above software by using the following
methods:
o To determine the installed version of IPX and the NETX shell, use the
Novell NVER command.
o To determine the version and mode of Windows, run Windows and choose the
About Program Manager command from the Program Manager Help menu.
o To determine the version of your Novell Windows support drivers, use the
Novell VERSION command. For example, type:
VERSION VNETWARE.386 <ENTER>
o To determine the version of your IPXODI.COM file, use the Novell VERSION
command. For example, type:
VERSION IPXODI.COM <ENTER>
2.2 BrightWorks Installation Instructions
This section provides the step-by-step instructions necessary to install
BrightWorks.
Use the following procedure to install BrightWorks on your network. You can
exit the installation at any time by choosing the Exit button in the lower
right corner of the installation screen.
1. Verify that you have a drive letter mapped to the SYS volume for the file
server on which you are installing this product.
2. Start Windows in enhanced mode.
3. Choose the Run command from the Program Manager File menu.
The Run dialog box displays.
4. At the prompt, enter the path and drive letter where you unzipped the
program files from the BBS and then type SETUP.
For example, type:
F:\BWORKS\SETUP <ENTER>
At this point a Log File is created and placed in your WINDOWS directory.
A Log File is an ASCII file listing the date, time and location of the
BrightWorks installation.
The Log File also lists any errors that occurred during installation. If
an error that prevents completion of the installation process occurs, the
Log File displays.
Several messages may appear at this point in the installation:
a - If BrightWorks finds an existing Log File, you are asked if you wish
to overwrite the old file. If you answer NO to preserve the old Log File,
you are prompted to enter a new Log File name. Enter the new file name,
and choose the OK button to continue.
b - If you are not running the BREQUEST.EXE or the Btrieve NLM, a message
displays informing you of the increased performance gained by using BREQUEST.
You are given the option to either abort the installation to load BREQUEST
or to continue with the installation. Choose the Yes button to exit the
installation and load the BREQUEST.EXE and/or the Btrieve NLM, or choose
the NO button to continue with the installation. Please refer to Chapter 32
for more information about Btrieve.
NOTE: It is highly recommended that you use BREQUEST as this will improve
the performance of data collection, auditing and reporting by at least
50% and by as much as 500%. It also improves upgrade performances.
c - A message displays regarding the default target drive. This message
informs you that mapped roots are not recognized by the install program.
Read the message, and choose the OK button to continue. The Choose Server
dialog box displays.
5. From the Choose Server dialog box, choose the file server on which you
want to install BrightWorks, and choose the OK button.
The Choose Server dialog box displays all the file servers to which
you are currently attached and have a drive mapped.
BrightWorks verifies that you have SUPERVISOR rights on the selected
file server and also checks to see that your \WINDOWS\SYSTEM directory
contains the appropriate files:
o VNETWARE.386
o VIPX.386
o NETWARE.DRV
Refer to the section in this chapter entitled "Before Installation" for
version information.
6. Select one of the following install options:
o Basic Install - runs the install process with minimal user input;
automatically creates the Program Manager group McAfee (if not found)
containing the BrightWorks program and Readme file icons and the
Crystal Reports program and the Readme file icons.
o Custom Install - allows you to choose whether or not to: copy all
BrightWorks program files to the network, retrieve fresh copies of
the BrightWorks inventory baseline file, retrieve fresh copies of
the BrightWorks administration files, configure Windows 3.1 for
BrightWorks, install Crystal Reports, install metering software to
server, retrieve fresh copies of the BrightWorks executable files,
or create the McAfee Program Manager group and its related icons.
o Upgrade - allows you to automatically upgrade from either
previous McAfee metering software or LAN Inventory software to
BrightWorks with minimal user input.
Refer to the appropriate section in this chapter for procedures
regarding the selected install option.
2.3 Basic Install
The Basic Install process automatically performs the following operations:
o Copies BrightWorks files to the network
o Installs the BrightWorks license
o Creates the Program Manager group McAfee and icons for BrightWorks and
the Readme file
Continue with the following steps to complete the Basic Install procedure:
7. Enter the full path name to where BrightWorks should be installed, and
choose the OK button.
The drive letter and full directory must coincide with the file server
you selected earlier. BrightWorks will create the directory if it
does not exist. The default drive letter is the first one found on the
server you specified. BWORKS is the default directory.
NOTES: a - The installation procedure allows you to specify a drive letter
that is mapped to a different server than the one you originally chose.
b - DO NOT install BrightWorks in the same directory as SiteMeter or LAN
Inventory. If you wish to upgrade from versions prior to LAI 3.1 and
SiteMeter 4.1, follow the upgrade procedures in this chapter.
If BrightWorks already exists in the specified directory, an option box
displays asking whether or not you wish to overwrite this copy of
BrightWorks.
If you are installing over a BrightWorks 1.0 or greater or an LAI 3.1
or greater, you will be prompted "Do you wish to overwrite your existing
Inventory data files?" If you answer YES, you will need to collect all of
the data again. Choosing NO preserves your data.
As indicated in this message box, the minimum space required for
BrightWorks is 15MB; the recommended free space is 24414K. If you
do not have the minimum space in the path you specified, an error message
displays and you are prompted to select a different path. If you have
the minimum but not the recommended free space, you are given the option
of continuing the install in the specified path or choosing another one
with more space.
8. Enter your Company Name, and choose the OK button.
The Company Name length must be between 1 and 20 characters.
9. Enter the full path name to SYS:\SYSTEM on your server.
The default is to the first drive letter found on the server you
specified.
10. If you are running NetWare 3.x, choose one of the following options to
make changes to the AUTOEXEC.NCF file:
o Have BrightWorks make changes to your existing AUTOEXEC.NCF file
and backup the old file as AUTOEXEC.BDI, or
o Have BrightWorks make changes to the AUTOEXEC.BDI file and
leave your existing AUTOEXEC.NCF file alone for you to change at a
later date. Refer to AUTOEXEC.BDI for the necessary changes.
11. If you wish to install the TSR option (SWATCHER used with SiteMeter),
choose the Yes button.
The default setting installs SMRPROXY into the SYS:SYSTEM directory.
In addition, you can select the Swatcher option in this box.
If you do not wish to use this option, choose the No button.
NOTE: SMRPROXY is automatically installed if you are loading SiteMeter on
a 3.x file server. If you wish to use Swatcher you must select that option.
If you are loading SiteMeter on a 2.x file server, you must select Swatcher.
12. Choose one of the following options to make the necessary changes to the
WIN.INI file:
o Have BrightWorks make changes now to your existing WIN.INI file
and backup the old file as *.BDI, or
o Have BrightWorks make changes later, saving needed changes as
*BDI. Refer to WIN.BDI for the necessary changes. (BrightWorks adds
the line "RPT=CRW.EXE^.rpt" to the WIN.INI file; you can still
execute BrightWorks without making this change.)
13. Choose the OK button in the information box indicating that the
installation completed.
14. Choose the OK button in the information box about the Readme file.
15. If you chose to modify the WIN.INI file in step 12, a dialog box
displays, giving you the following options:
o Reboot the PC
o Terminate Windows and exit to DOS
o Restart Windows
Select the desired option and choose the OK button.
When the installation is complete, a message displays informing you to
check the Log File and display the Readme file for additional information.
Double click on the Readme file icon to open the file.
2.4 Custom Install
If you select the Custom Install option, the Install Options dialog box
displays. This dialog box allows you to select the installation options
to be performed. The procedures required for the Custom Install depend on
the options selected in the Install Options dialog box. If you choose all
the options, the procedure is identical to the Basic Install. The options
in the dialog box are as follows:
o Copy program files to the network - copies all BrightWorks files to
the target directory.
o Copy fresh Inventory data files to network - copies new data files to
the network for use with the inventory capability.
o Retrieve fresh copies of the Inventory Baseline files - copies only the
Inventory baseline files into the BWORKS program directory. Your existing
baseline information is overwritten.
o Retrieve fresh copies of the Inventory Administration files - copies
only the Inventory administration files into the BWORKS program directory.
o Configure Windows 3.1 for product - makes the necessary changes to your
WIN.INI file.
o Install Crystal Reports - installs the Crystal Reports files, used with
the reporting functions with BrightWorks' metering and inventory capabilities.
o Install Metering software to server - installs BrightWorks' metering
capability.
o Create Program Manager group - creates the MCAFEE Program Manager
group and icons.
7. Select all the desired options from the dialog box, and then choose
the OK button.
8. Enter the full path name to where BrightWorks should be installed, and
choose the OK button. (If you did not choose to copy BrightWorks files
to the network only, skip to step 9.)
The drive letter and full directory must coincide with the file server
you selected earlier. BrightWorks will create the directory if it
does not exist. The default drive letter is the first one found on the
server you specified. BWORKS is the default directory.
NOTES: a - The installation procedure allows you to specify a drive letter
that is mapped to a different server than the one you originally chose.
b - DO NOT install BrightWorks in the same directory as SiteMeter or LAN
Inventory. If you wish to upgrade, follow the upgrade procedures in this
chapter.
If BrightWorks already exists in the specified directory, an option box
displays asking whether or not you wish to overwrite this copy of
BrightWorks.
If you are installing over a BrightWorks 1.0 or greater or a LAI 3.1 or
greater, you will be prompted "Do you wish to overwrite your existing
Inventory files?" If you answer YES, you will need to collect all of the data
again. Choosing NO preserves your data.
As indicated in this message box, the minimum space required for
BrightWorks is 15MB; the recommended free space is 24414K. If you do
not have the minimum space in the path you specified, an error message
displays and you are prompted to select a different path. If you have
the minimum but not the recommended free space, you are given the
option of continuing the install in the specified path or choosing
another one with more space.
9. Enter your Company Name, and choose the OK button. (If you did not
choose to install the files, skip to step 10.)
The Company Name length must be between 1 and 20 characters.
10. Enter the full path name to SYS:\SYSTEM on your server. (If you did
not choose to install the metering software, skip to step 13.)
The default is to the first drive letter found on the server you
specified.
11. If you are running NetWare 3.x, choose one of the following options to
make changes to the AUTOEXEC.NCF file:
o Have BrightWorks make changes to your existing AUTOEXEC.NCF file
and backup the old file as AUTOEXEC.BDI, or
o Have BrightWorks make changes to the AUTOEXEC.BDI file and
leave your existing AUTOEXEC.NCF file alone for you to change at a
later date. Refer to AUTOEXEC.BDI for the necessary changes.
12. If you wish to install the TSR option (SWATCHER used with SiteMeter),
choose the Yes button.
The default setting installs SMRPROXY into the SYS:SYSTEM directory.
In addition, you can select the Swatcher option in this box.
If you do not wish to use this option, choose the No button.
NOTE: SMRPROXY is automatically installed if you are loading SiteMeter on
a 3.x file server. If you wish to use Swatcher you must select that option.
If you are loading SiteMeter on a 2.x file server, you must select Swatcher.
13. Choose one of the following options to make the necessary changes to
the WIN.INI file. (If you did not choose to configure Windows 3.1 for
the product, skip to step 14.)
o Have BrightWorks make changes now to your existing WIN.INI file
and backup the old file as *.BDI, or
o Have BrightWorks make changes later, saving needed changes as
*BDI. Refer to WIN.BDI for the necessary changes. (BrightWorks
adds the line "RPT=CRW.EXE^.rpt" to the WIN.INI file; you can
still execute BrightWorks without making this change.)
14. Choose the OK button in the information box indicating that the
installation completed.
15. Choose the OK button in the information box about the Readme file.
16. If you chose to modify the WIN.INI file in step 13, a dialog box
displays giving you the following options:
o Reboot the PC
o Terminate Windows and exit to DOS
o Restart Windows
Select the desired option and choose the OK button.
When installation is complete, a message displays informing you to check
the Log File and display the Readme file for additional information.
Double click on the Readme file icon to open the file.
2.5 Upgrade Procedures
The Upgrade Install offers you several options. You either can install
BrightWorks, SiteMeter or LAN Inventory and copy the information contained
in your current versions of these products, or you can just copy the
information from existing software into the new BWORKS directory. Your
existing database information is retained while your BrightWorks system
is upgraded.
NOTE: Before upgrading from previous McAfee metering software or LAN
Inventory, make sure you backup all existing product files. If you are
upgrading from SiteMeter, you can perform the Basic Install instead
of this upgrade procedure.
The Upgrade option automatically performs the following actions:
o Copies BrightWorks files to the network
o Creates the Program Manager group McAfee and icons for BrightWorks and
the Readme file
Continue with the following steps to complete the Upgrade Install procedure:
7. Select an option from the Install Options dialog box.
The dialog box gives you the following options for upgrading:
o Upgrade from Fusion 1.x, LAN Automatic Inventory 3.1x & SiteMeter
4.1x
o Install and import LAN Inventory data and previous McAfee metering
data
o Install and import LAN Inventory data only
o Install and import previous McAfee metering data only
o Import LAN Inventory data and previous McAfee metering data only
o Import LAN Inventory data only
o Import previous McAfee metering data only
NOTE: The import options are only available if you are upgrading from
versions prior to LAI 3.1 and SiteMeter 4.1.
The import feature allows you to retain the data you have in either
your LAN Inventory or previous McAfee metering software. (If you have
already installed SiteMeter, you do not need to import to retain the
metering data.)
NOTE: You can only select one of the import only options if you have already
installed BrightWorks on your network. If you have not installed BrightWorks,
select one of the first three options to install and import previous data.
8. Enter the full path name to where BrightWorks should be installed, and
choose the OK button.
The drive letter and full directory must coincide with the file server
you selected earlier. BrightWorks will create the directory if it
does not exist. The default drive letter is the first one found on
the server you specified.
NOTES: a - The installation procedure allows you to specify a drive letter
that is mapped to a different server than the one you originally chose.
b - DO NOT install BrightWorks in the same directory as SiteMeter or LAN
Inventory.
If BrightWorks already exists in the specified directory, an option
box displays asking whether or not you wish to overwrite this copy of
BrightWorks.
As indicated in this message box, the minimum space required for
BrightWorks is 15MB; the recommended free space is 24414K. If you do
not have the minimum space in the path you specified, an error message
displays and you are prompted to select a different path. If you have
the minimum but not the recommended free space, you are given the option
of continuing the install in the specified path or choosing another one
with more space.
If LAI files are detected in the specified directory, you are prompted
to choose whether or not you want to use the new BrightWorks Software
list. Either choose the Yes button to use the new Software list, or
choose the No button to convert your existing Software list. (Note that
converting your existing list may result in duplicate software entries.)
We highly recommend using the new list for the most up-to-date software
information.
If you are installing over a version of BrightWorks 1.0 or greater or
LAI 3.1 or greater, you will be prompted "Do you wish to overwrite your
existing Inventory data files?" If you answer YES, you will need to
collect the data again. Choosing NO preserves your data.
9. Enter your Company Name, and choose the OK button.
The Company Name length must be between 1 and 20 characters.
10. Enter the full path name to SYS:\SYSTEM on your server.
The default is to the first drive letter found on the server you
specified.
11. If you are running NetWare 3.x, choose one of the following options to
make changes to the AUTOEXEC.NCF file:
o Have BrightWorks make changes to your existing AUTOEXEC.NCF
file and backup the old file as AUTOEXEC.BDI, or
o Have BrightWorks make changes to the AUTOEXEC.BDI file and
leave your existing AUTOEXEC.NCF file alone for you to change at a
later date. Refer to AUTOEXEC.BDI for the necessary changes.
12. If you wish to install the TSR option (SWATCHER used with SiteMeter),
choose the Yes button.
The default setting installs SMRPROXY into the SYS:SYSTEM directory.
In addition, you can select the Swatcher option in this box.
If you do not wish to use this option, choose the No button.
NOTE: SMRPROXY is automatically installed if you are loading SiteMeter on
a 3.x file server. If you wish to use Swatcher you must select that option.
If you are loading SiteMeter on a 2.x file server, you must select Swatcher.
13. At the prompt, enter the path name for the existing copy of LAN Inventory
and choose the OK button. (If you did not choose to import LAN Inventory
data, skip this step.)
BrightWorks verifies that you have a previous version of LAN Inventory,
makes a duplicate copy of the files and then converts them to the
BrightWorks software.
14. At the prompt, enter the path name of the existing copy of metering
software and choose the OK button. (If you did not choose to import
previous software metering data, skip this step.)
BrightWorks verifies that you have a previous version of McAfee metering
software, makes a duplicate copy of the files and then converts them
to the BrightWorks software.
15. Choose one of the following options to make the necessary changes to
the WIN.INI file:
o Have BrightWorks make changes now to your existing WIN.INI file
and backup the old file as *.BDI, or
o Have BrightWorks make changes later, saving needed changes as
*BDI. Refer to WIN.BDI for the necessary changes. (BrightWorks
adds the line "RPT=CRW.EXE^.rpt" to the WIN.INI file; you can
still execute BrightWorks without making this change.)
16. Choose the OK button in the information box indicating that the
installation completed.
17. Choose the OK button in the information box about the Readme file.
18. If you chose to modify the WIN.INI file in step 15, a dialog box
displays, giving you the following options:
o Reboot the PC
o Terminate Windows and exit to DOS
o Restart Windows
Select the desired option and choose the OK button.
When the upgrade is complete, a message displays informing you to check the
Log File and display the Readme file for additional information. Double
click on the Readme file icon to open the file.
NOTE: If you have upgraded to BrightWorks from LAN Inventory v2.xx (and if
you have installed BrightWorks in your existing LAN Inventory v2.xx
directory), you must re-inventory hardware only on each workstation
(i.e., run EQUIP/MACEQUIP) before performing your initial BrightWorks audit.
For all workstations that are not re-inventoried before performing the
initial BrightWorks audit, their inventory will be removed from the baseline
and reported as "missing." If you do not perform EQUIP prior to performing
an audit, you will lose the information on the PCs from the old database.
2.6 Installing NLMs
This quick start guide reviews the installation process and provides
importantinformation about installing the product NLMs.
WARNING: BTRIEVE Version 6.10 or later must be properly loaded to run the
BrightWorks/SiteMeter Administration program. For instructions on setting up
server based Btrieve, please see Chapter 32 in this manual. For
instructions on setting local PC based Btrieve, please see Step 3 below.
Note: Btrieve version 6.10c is located in Compuserve. Simply GO NOVLIB,
Library 7 and download BTR61.EXE (947,265 bytes, December 6, 1993).
If you get the following error message:
"BrightWorks: The Novell Brequester has not been loaded. BrightWorks database
will not be optimized. To optimize the performance of this program, load the
Btrieve.NLM on your server, the Brequest.EXE TSR on your workstation (with
argument /d:17000), and restart Windows and BrightWorks."
when starting SiteMeter/BrightWorks and to the best of your knowledge,
Btrieve has been properly loaded, please take the following steps:
If you want to run BREQUEST for server based Btrieve, this error could be
occuring because you have loaded the incorrect WBTRCALL.DLL file. Take the
following steps:
1. Exit Windows.
2. Change to the \BWORKS directory.
3. Run USEBRQ.BAT.
This program will copy the proper WBTRCALL.DLL file into the
\BWORKS directory for BREQUEST.EXE.
4. Copy the new WBTRCALL.DLL into your \Windows directory.
5. Restart Windows.
6. Run BrightWorks again.
This error may also occur if the BTRIEVE.NLM or the BSPXCOM.NLM is not be
loaded on the fileserver. Please take the following steps:
1. At the fileserver console, type BSTOP.
This unloads the NLMs.
2. Type BSTART.
This loads both BTRIEVE.NLM and BSPXCOM.NLM on the fileserver.
If you want to work with the client based BTRIEVE instead of the server
based BTRIEVE (BREQUEST.EXE), then take these steps:
1. Run USEBTR.BAT.
This ensures that you are running the proper WBTRCALL.DLL file for client
based BTRIEVE.
2. Add the following section to your WIN.INI:
[btrieve]
options=/p:3072/f:22/t:btr.trn/e
3. Restart Windows.
4. Run BrightWorks again.
2.7 Troubleshooting
If you receive any errors while installing or upgrading BrightWorks, display
the log file to view the errors and possible solutions.
The following lists the installation error messages and their explanations.
Error calling DLL function.
This indicates that install was unable to find PROGLIB.DLL or
NETWARE.DRV didn't load or wasn't configured in your SYSTEM.INI file.
This could happen if the NetWare shell was not loaded before running
Windows or if the wrong NetWare driver was loaded for Windows.
Please refer to the installation requirements in this manual.
Also, make sure:
-The shells are loaded.
-The following line is included in your SYSTEM.INI file in the
[386Enh] section: network=*vnetbios, vnetware.386, vipx.386
-You have Write and Modify rights to your Windows directory.
Install requires temporary storage on your hard drive, approximately 300K
bytes. There is not enough space on your XXXX.
XXXX is the drive name specified. This message will display if the
drive you specified does not have the space required to run the
installation program.
Unable to copy or decompress file: FILENAME. Make sure that you have
permission to write to the designated path and that you included the drive
letter and that there is enough space on the destination disk.
FILENAME is the file to be copied or decompressed.
This message will display if 1) you do not have the write permission
2) there is not enough space on the destination disk or 3) the
volume (i.e., SYS) that the install is trying to write to does not
exist. Log in as supervisor or equivalent.
Install did not find a previously installed copy of XXXXXX in YYYYYY.
Choose OK to choose another path.
XXXXXX is the name of the product which you want to upgrade.
YYYYYY is the name of the path you gave for the install to check
for the previously installed product. This message will display
if the install did not find the previously installed product which
you want to upgrade in the path you specified. Make sure you give
the correct path to the install to find the previously installed
product for upgrading.
This installation failed. Please run the install again to be sure that
BrightWorks is installed correctly. Choose OK to exit install and view the
install log file.
This message will display when the installation has encountered
severe problems and has aborted. A log file may have
the error message. Use Windows Notepad utility to view this file.
Make the required change and then run the install again.
Fatal Error: [Error#]
Verify that you meet the BrightWorks configuration requirements and
then contact McAfee Technical Support with the Error #.
Validate IPX/NETX versions, encountered NetWare Error #.
The install process was unable to determine if your IPX and/or NETX
versions meet the installation requirements. If your environment
meets the minimum requirements, continue with the installation.
You have not configured Windows to load VIPX.386. Please consult manual for
further information.
The following line must be included in the SYSTEM.INI file, in the
[386Enh] section:
network=*vnetbios, vnetware.386, vipx.386
Install detected problems with your Configuration. Click on OK to exit and
view log file.
View the Log File for information to correct your configuration in
accordance with the BrightWorks installation requirements. Once you
have corrected your configuration, re-run the installation process.
Unrecoverable Error
Verify that you meet the BrightWorks configuration requirements, and
then contact McAfee Technical Support with the Error #.
3.0 Getting Started
Chapter 2 described the BrightWorks installation and upgrade instructions.
This chapter introduces and discusses the BrightWorks application window.
NOTE: This chapter pertains to BrightWorks, SiteMeter and LAN Inventory.
3.1 Introduction
The following chart describes the sections in this chapter:
SECTION DESCRIPTION
The BrightWorks Console Provides instructions on launching the
BrightWorks console, selecting menu bar
items, using the tool bar as an alternative
to the menu bar, and using BrightWorks'
on-line help.
Printer Setup & Administration Provides procedures for defining the global
print settings on which you want to generate
BrightWorks reports.
Error Handling Discusses how to handle errors.
3.2 The BrightWorks Console
This section describes the BrightWorks console. In addition to instructions
for launching and exiting BrightWorks, it discusses the menu bar, tool bar,
and help facility.
3.2.1 Windows Terms
BrightWorks should be used with a mouse. The table below briefly defines
several Windows terms regarding the use of the mouse and product windows.
Cancel Button: Choosing the Cancel button exits the current dialog box
without saving any changes you made in this dialog box or
without executing a command you selected in this dialog box.
Choose: Click the left mouse button (or use a key combination) on an
item to initiate an action. For example, "Choose the
BrightWorks icon."
Click: Press the left mouse button once.
Double click: Press the left mouse button twice in quick succession.
Icon: A graphic representation of an executable in Windows.
Point: Position the mouse until the tip of the pointer on the
screen rests on the desired item.
Scroll: Use the scroll bars and buttons to move through a list of
items.
Select: Mark an item by clicking on it or by highlighting it with
either key combinations or the mouse. For example, "Select
the Include Path option."
NOTE: The remainder of this manual assumes that you are familiar with
Windows. Refer to your Microsoft Windows manual for information on the
fundamental operating conventions of the Windows environment.
3.2.2 Accessing BrightWorks
After successfully installing BrightWorks, a McAfee Program Manager group
and a BrightWorks program icon are created on your Windows desktop.
Use the following procedure to launch BrightWorks.
1. Load Brequest.
Either server-based or client-based Btrieve can be used with BrightWorks.
Server-based Btrieve is strongly recommended due to its increased
database access speed.
Upon installation, BrightWorks is configured to run with Brequest.
If you are running client-based Btrieve, you must run the USEBTR.BAT
file in the Fusion program directory before launching BrightWorks.
This batch file configures BrightWorks to run with local Btrieve. For
example, from within the Fusion program directory, issue the following
command:
USEBTR <ENTER>
2. Run Windows, and double click on the BrightWorks program icon.
If you are using Novell's local Btrieve, a message displays recommending
that you use BREQUEST for increased database access speed. This message
will only display when BrightWorks cannot detect Brequest. It will also
display when BrightWorks is configured to run with client-based Btrieve
(i.e., by running the USEBTR.BAT file). To disable the warning message
under all circumstances, place a checkmark in the "Disable warning
message when Brequest isn't running" field.
(To re-enable the warning message, the FUSION.INI file must be edited.)
Refer to the section entitled "Consider Improving BrightWorks' Database
Performance" in section 12.0 of this manual for more information about
the Btrieve database.
Choose the OK button to continue the BrightWorks program launch. The
BrightWorks application window displays.
The application window consists of the following items which are
discussed in this section:
o The BrightWorks Menu Bar
o The BrightWorks Tool Bar
o Access to BrightWorks' On-Line Help
3.2.3 Exiting BrightWorks
Use the following procedure to end a BrighWorks session.
1. Choose the Exit command from the File menu.
A dialog box displays prompting you to confirm the exit action.
2. To save your monitor configuration, check the 'Save monitor
configuration' option.
Checking this option will save the configuration of any metering
windows that are currently open in your BrightWorks application window.
All open metering windows will be automatically restored upon starting
your next BrightWorks session.
3. Choose the OK button to close the BrightWorks application.
The BrightWorks menu bar consists of several menu items. To choose a menu,
point to the menu name and click the left mouse button. The menu displays.
3.2.4 BrightWorks Menu Bar
The general purpose of each menu item is defined below:
o File - Lists file oriented commands, including those for configuring
global print settings and exiting BrightWorks. For several of the File
menu commands, the command text and its associated action when selected
depend on the currently active window in the BrightWorks application window.
For example, when the List of Available Scripts window is active, the New
Script and Open Script commands are listed under the File menu.
o Edit - Lists the standard editing commands used when creating and editing
software distribution scripts.
o Administration - Lists sub-menus for each BrightWorks capability. When
selected, each sub-menu displays a list of commands used for configuring and
managing the capability parameters.
o Tools - Lists commands for viewing and managing capability-specific
information. For example, choose the Inventory command to view and manage
the inventory collected by BrightWorks' inventory features.
o Reports - Lists commands for accessing specific categories of BrightWorks
reports.
o Window - Lists commands for positioning the open document windows in the
BrightWorks application window.
o Help - Lists commands to access BrightWorks' on-line Windows hypertext
help.
NOTE: Holding down the left mouse button over a menu command causes the
function of the command to display in the BrightWorks title bar at the top
of the BrightWorks application window.
3.2.5 BrightWorks Tool Bar
When using BrightWorks with a mouse, BrightWorks' tool bar buttons provide
an alternative for accessing the most frequently used BrightWorks functions.
Instead of choosing commands from the drop-down menus, you can choose the
tool bar buttons to perform the same tasks. For example, to define
applications to be metered, you can either choose Define Metered Applications
from the Metering command on the Administration menu, or you can simply
choose the Metering tool bar button. Both actions result in displaying the
Define Metered Applications dialog box.
The function of each tool bar button is described below:
o Metering - Displays the Define Metered Applications dialog box used for
adding, modifying and deleting applications to be metered.
o Security - Displays the Define Authorized Files dialog box used for
specifying files that are secure.
o Monitor - Displays the View Application Usage dialog box used for
determining which applications are being used and by whom.
o Inventory - Displays the View Inventory dialog box used for viewing and
managing the inventory of each audited workstation.
o Distribute - Displays the Available Packages window used for viewing,
creating and managing packages for distribution.
o Remote - Provides access to optional McAfee NETremote+ software for
automated user support.
o Tickets - Provides access to optional McAfee LAN Support Center software
for help desk automation.
o Alerting - Displays the Alerting Options dialog box used for defining and
scheduling auditing alerts.
o Reports - Displays the report generator that was last selected from the
Report menu. For example, if the Inventory and Distribution command was
last chosen from the Reports menu, then the Choose Report dialog box will
display, enabling you to generate inventory and distribution reports.
NOTE: Holding down the left mouse button over a tool bar button causes the
function of the button to display in the BrightWorks title bar at the top of
the BrightWorks application window.
3.2.6 Using the Keyboard
To use BrightWorks without a mouse, perform the standard Windows keyboard
actions to navigate through the program.
Each menu item on the BrightWorks menu bar has a keyboard mnemonic. Press
the <ALT> key in combination with the keyboard mnemonic key to choose a menu
and cause the menu to drop down. For example, press the <ALT><F> keys to
choose the File menu and display its commands.
Each command also has a keyboard mnemonic. Once the menu is displayed
(i.e., "dropped down"), press the keyboard mnemonic of the command you want
to choose.
For example, from the File menu, press <P> to choose the Printer Setup
command. You can also use the <up/down arrow> keys to move the highlight
to a desired command and press <ENTER> to select the command.
For detailed information on using a Windows application with the keyboard,
refer to your Windows documentation.
NOTE: Some BrightWorks features require the use of a mouse and cannot be
accessed with the keyboard.
3.2.7 BrightWorks' Help Facility
BrightWorks' help facility provides on-line assistance for using the
BrightWorks software. To get information quickly about a BrightWorks
feature or procedure, choose the Help Index command from the Help menu.
Choosing the Help Index command displays an index list of topics.
Choose the topic for which you require assistance.
BrightWorks' help system is written in a standard Windows hypertext format.
This means that you can jump from one topic to another by simply choosing
topic names from a list. Several buttons display across the top of the Help
dialog box allowing you to search for topics and also to view a list of
the topics you have visited.
For detailed information on using a Windows help facility, refer to your
Windows documentation.
3.2.8 The .INI File
Upon installing the BrightWorks software, the FUSION.INI file is
created and placed in the Windows directory of the local workstation. The
file can consist of the following sections:
o [ShowBrequestWarning] - This section indicates the status of the Brequest
warning which displays upon launching BrightWorks when BrightWorks does not
detect the presence of the Btrieve NLM or VAP. This section contains an
'Init=' line which indicates whether or not the warning is disabled
(i.e., 'Init=No' when warning is disabled; 'Init=Yes' when warning is
enabled).
o The warning message can be disabled from within BrightWorks by checking
the "Disable message when Brequest isn't running" field when launching the
application. The only way to re-enable the warning message after it has
been disabled is to edit the FUSION.INI file, and enter 'Init=Yes' in this
section.
o [Report Preference] - This section indicates the reporting module that
will be accessed upon choosing the BrightWorks Reports tool bar button.
Choosing the Reports tool bar button accesses either the
Inventory/Distribution reports or the Metering/Security reports, depending
on the command that was last selected from the Reports menu. For example,
the following section will be included in the FUSION.INI file if the
Inventory and Distribution command was last selected from the Reports menu:
[Report Preference]
Module=Inventory
o [ShowBanner] - This section can be manually added to the INI file in
order to disable the About BrightWorks dialog box which displays upon
launching BrightWorks. To disable the About dialog box at start-up time,
enter the following:
[ShowBanner]
Init=No
o To re-enable the warning message, either delete this section or enter
'Init=Yes.'
o [DisableExitPrompt] - This section can be manually added to the INI file
in order to disable the prompt which displays upon exiting BrightWorks.
This prompt allows you to save the configuration of any open metering
windows. To disable the exit prompt, add the following section to the
FUSION.INI file:
[DisableExitPrompt]
AutoSave=Yes
o Note that an 'AutoSave=Yes' setting will inhibit the exit prompt and
save the configuration of the open metering windows. An 'AutoSave=No'
setting will also inhibit the exit prompt but will not save the open
metering window settings.
o [Alternate EXE] - This section can be manually added to the INI file in
order to change the applications that are launched when the BrightWorks
Remote or Tickets tool bar buttons are pressed. For example, to run a third
party executable help desk program when the Tickets tool bar button is
chosen, add the following section to the FUSION.INI file:
[Alternate EXE]
ticket=3rdparty.exe
o [downgrade] - This option lets you instruct the console to display either
only metering or only inventory functions when it displays. For only
metering functions, add the following section to the FUSION.INI file:
[downgrade]
module=metering
To display only inventory functions, add the following section to the
FUSION.INI file:
[downgrade]
module=inventory
o To launch another program when the BrightWorks Remote tool bar button is
chosen, add the line 'remote=' to this section and indicate the alternative
application's executable file name. In all cases, to successfully launch
another program from within Fusion, the program must be in the Windows
directory, Windows system directory, DOS path or search path.
3.3 Printer Setup and Administration
Before printing BrightWorks reports, you should review the global print
parameters to be sure they reflect the printer settings that you require.
Printer settings include:
o Printer destination
o Page orientation (portrait/landscape)
o Paper size and source
o Graphics resolution
The procedures for customizing the contents of individual BrightWorks reports
are discussed in the corresponding parts of this manual (e.g., Chapter 18
in Inventry.txt discusses "BrightWorks Inventory Reports"). This section
briefly presents the procedures for viewing and changing Windows global print
settings (e.g., target printer, paper size).
NOTE: Please refer to your Windows manual for detailed procedures on
modifying the Windows print settings.
Use the following procedure to review and change your print settings.
1. Choose the Printer Setup command from the File menu.
The Print Setup dialog box displays.
NOTE: The Orientation section of this dialog box does not appear when you
choose the Printer Setup command while the metering reports window is open.
2. Select the printer you want to use for printing BrightWorks reports.
The printer selected from your Windows printer control is selected as
the default. To use another printer, select a Specific Printer from
the drop-down list associated with this field.
NOTE: Choosing a specific printer does not permanently change your
printer setting.
3. Select the desired orientation and paper parameters.
Choose either the Portrait (long) or Landscape (wide) Orientation setting.
Use the drop-down lists to define the Paper Size and Paper Source
settings.
4. To make additional changes to the selected printer configuration, choose
the Options button.
Additional settings include dithering and intensity control.
5. Choose the OK button in the Print Setup dialog box to save the print
settings.
3.4 Error Handling
If you encounter an error while using BrightWorks, a message box displays
with a description of the error. Choosing the OK button returns you to
either the previous screen to select another choice or to the BrightWorks
application window if no other choices are available.
Chapter 29 of this manual lists and describes all BrightWorks errors.
4.0 Tutorials
Chapter 3 described using the BrightWorks console and keyboard. This
chapter presents brief tutorials to introduce BrightWorks' metering,
inventory and software distribution capabilities.
NOTE: This chapter pertains to BrightWorks, SiteMeter and LAN Inventory.
4.1 Metering Tutorial
This tutorial outlines the major steps in using BrightWorks to meter your
applications and file protect your network software.
The steps in this tutorial include the following:
1. Creating a Metered Application
2. Viewing Application Usage
3. Creating an Authorized File
4. Setting the File Scan Interval
NOTES: a - BrightWorks' metering capability must be installed on your
network before beginning the tutorial. If you have not already done so,
please refer to Chapter 2 for installation instructions.
b - The options and features mentioned in this tutorial are discussed in
detail in Metering.txt of this manual.
You will realize the following benefits by using BrightWorks' metering on
your network:
o Ensured compliance with software license agreements--so you stay legal
o Controlled access to sensitive network applications with real time
trustee rights granting
o Maximized effectiveness of available resources with queue back feature
for metered applications
o Virus protection for your files
o Suite metering to accurately meter groups of applications
o Security features to maintain network integrity
4.1.1 Creating a Metered Application
A metered application is a program file that is registered for metering
with BrightWorks. To register an application for metering, you must specify
certain information about the application.
For this tutorial, we are going to meter the Windows program CLOCK.EXE. The
tutorial assumes that you are running Windows off of the network and that
therefore CLOCK.EXE is on a network drive. The tutorial assumes you have the
BrightWorks console open and that you have the SITEMETR.NLM running.
Use the following procedure to create this metered application.
1. Choose the Metering command from the Administration menu. From the
sub-menu that displays, choose the Define Metered Applications command.
The Define Metered Applications dialog box displays. This dialog box
displays all files currently registered with BrightWorks' metering and
offers the following options:
o Add - allows you to register an application for metering.
o Modify - allows you to change a metered application's information.
o Delete - allows you to remove an application from metering.
o Attach to/Detach from File Servers - allows you to attach to or
detach from different file servers while in BrightWorks.
2. Choose the Add button.
The Add Metered Application dialog box displays.
3. Choose the Add button.
The Browse for Files to Meter dialog box displays. This is a standard
Windows dialog box.
4. Select the file CLOCK.EXE from your Windows directory.
If you are running Windows from your local drive, you must select a
different file stored on the network for this tutorial. BrightWorks does
not meter local files.
5. Select the Include Path option.
6. Choose the OK button to exit this dialog box and insert the file name in
the File(s) to Meter text box.
7. Enter CLOCK in the Metered Application Name text box.
8. Enter "CLOCK for Windows" in the Full Name text box.
9. Enter "20" in the Maximum Number of Concurrent Users text box.
10. Enter "2" in the Queue Back Time text box.
Queue Back Time is the length of time an application is held
exclusively for a queued user after he or she has been notified of its
availability. This sets the queue back time to two minutes for CLOCK.EXE.
NOTE: For this tutorial, we are not assigning a password or trustee rights
to CLOCK.EXE.
11. Choose the OK button to save this information.
You are returned to the Define Metered Applications dialog box.
This completes the steps for creating a metered application for the
utility CLOCK.EXE. Now only 20 concurrent users can use CLOCK.EXE on
your network.
NOTE: Refer to the section 6.3 entitled "Registering Applications for
Software Metering" for more information about creating metered applications.
12. Choose the Close button to return to the BrightWorks console.
Continue with the next section to view application usage for this program.
4.1.2 Viewing Application Usage
Once you create metered applications, you can view their usage on your
network. Use the following procedure to view how many people are running
CLOCK.EXE.
1. Minimize the BrightWorks console.
2. Load SMRAGENT.EXE.
This may already be loaded from the WIN.INI. You can determine if this
file is loaded by choosing the Windows Run command from the File menu and
then searching for SMRAGENT in the BWORKS directory.
3. From the Program Manager, choose the Clock icon.
The clock displays on your screen.
4. Minimize the clock window.
5. Return to the BrightWorks console.
6. Choose the Monitor button from the tool bar.
The View Application Usage dialog box displays.
7. Select the file server where CLOCK.EXE resides.
8. Choose the OK button.
The Application Usage window for the file server you have selected
displays. In the left hand side of the window, the program CLOCK.EXE
is listed. The bar next to it indicates how many users are
currently using this program.
9. Position the cursor to the end of the usage graph bar and depress the
left mouse button.
A pop-up menu displays.
10. Choose the View Current Users command.
The Current Users window displays. Your login name will appear in this
list as well as any other network users running CLOCK.EXE.
11. Exit this window to return to the application usage graph.
This completes the steps for viewing a metered application with the graphic
display. Once you add additional metered applications, this graph will
reflect usage information for every application you meter.
NOTE: Refer to section 8.3 entitled "Viewing Application Usage" for more
information about viewing application usage. If you wish to remove metering
from CLOCK.EXE at this point, refer to section 6.3.5 entitled "Deleting
Metered Applications."
Continue the metering tutorial to protect files against viruses.
4.1.3 Creating an Authorized File
BrightWorks' metering protects your network against virus infection by
checking each file against a registered copy before it is run. This process
is called File Integrity Scanning.
For this part of the tutorial, we will register the file CLOCK.EXE for file
integrity scanning.
Use the following procedure to register CLOCK.EXE for protection.
1. Choose the Security command from the Administration menu. From the
sub-menu that displays, choose the Define Authorized Files command.
The Define Authorized Files dialog box displays. From this dialog box
you can:
o Add files to the Authorized Files list
o Reprotect files that are already authorized
o Delete files that have been authorized
o Attach to/Detach from different file servers
2. Choose the Add button.
The Browse for Files to Authorize dialog box displays.
3. Select CLOCK.EXE.
4. Choose the OK button.
CLOCK.EXE is listed in the Currently Authorized Files list.
5. Choose the Close button.
CLOCK.EXE is now an authorized file.
NOTE: Refer to section 7.2.2 entitled "Adding Authorized Files" for more
information about authorizing applications for file protection.
Continue with the next section to specify how often CLOCK.EXE should be
checked for any changes.
4.1.4 Specifying the File Scan Interval
BrightWorks' metering lets you specify how often files should be checked for
changes before they are executed.
Use the following procedure to set the File Scan Interval for the
authorized file, CLOCK.EXE.
1. Choose the Security command from the Administration menu. From the
sub-menu that displays, choose the Specify File Scan Interval command.
The Specify File Scan Interval dialog box displays.
2. Slide the slide bar until the value underneath reads 20 minutes.
3. Choose the OK button.
Now CLOCK.EXE will be checked every 20 minutes for changes to protect
your network from viruses.
NOTE: Refer to section 7.4 entitled "Specifying the File Scan Interval" for
more information about specifying the file scan interval. If you wish to
remove file protection from CLOCK.EXE at this point, follow the instructions
in section 7.2.4 entitled "Deleting Authorized Files."
This completes the metering tutorial. All of the features introduced here
are described in full detail in Metering.txt of this manual.
4.2 Inventory Tutorial
This tutorial outlines the major steps in using BrightWorks to perform an
inventory and a subsequent audit of the components of your LAN.
The steps in this tutorial include the following:
1. Collecting Inventory Data (using the EQUIP.EXE program)
2. Configuring the Audit Parameters
3. Running an Audit
4. Viewing the Audit Results (audit log and inventory details)
NOTES: a - BrightWorks' inventory component must be installed on your
network before beginning the tutorial. If you have not already done so,
please refer to Chapter 2 for installation instructions.
b - The options and features mentioned in this tutorial are discussed in
detail in Inventry.txt of this manual.
You will realize the following benefits by using BrightWorks' inventory
capability on your network:
o Reduce the time required to troubleshoot user and network problems
with an accurate, up-to-date hardware and software inventory
o Eliminate the need for manual inventory by automatically recording and
detecting changes in software and hardware configurations
o Inventory multiple sites to maximize resource usage
o Reduce the time required to input new applications with auto-learning
feature
o Keep records up-to-date and inform purchase decisions with detailed
vendor and warranty data tracking
o Reduce downtime by detecting outdated equipment
4.2.1 Collecting Inventory Data
EQUIP.EXE is the program used to collect the inventory data of your
networked PCs. The program is executed at the machine on which you want
to perform the inventory. Inventory data includes of hardware, software
and system file information. Note that before running EQUIP you must set
up the Btrieve database.
Use the following procedure to collect a workstation's inventory data.
1. Proceed to the PC workstation for which you want to collect inventory
data.
2. Make the BWORKS directory your current directory.
Use the DOS CD command to change into the BWORKS program directory, or
map a search drive to the BWORKS directory.
3. Setup the Btrieve database.
BrightWorks provides two batch files which setup the Btrieve database.
Issue the batch file which corresponds to the method of Btrieve you are
using.
o BRQ.BAT automatically issues the Btrieve setup command and loads
Brequest. Brequest uses 25-49KB of RAM, depending on the version
and the command line switches used. It is approximately 250% faster
than the local Btrieve; it requires, however, that the NLM be loaded
on the file server. The BRQ.BAT file consists of the following:
BREQUEST /D:17000
o BTR.BAT automatically issues the Btrieve setup command and loads
local Btrieve. Btrieve uses approximately 85KB of RAM, depending on
the command line switches used. It is much slower than Brequest.
The BTR.BAT file consists of the following:
BTRIEVE /P:3072 /F:22 /T:BTR.TRN /E
NOTE: Because of the increase in speed, Brequest is recommended.
4. Issue the EQUIP command and collect the hardware and software component
data for the PC you are using.
EQUIP /h /s <ENTER>
where /h is the command line option used to specify hardware collection;
/s is the command line option used to specify software collection. All
EQUIP command line options are listed in section 14.2 entitled "EQUIP
Command Line Reference."
5. Respond to the prompts that display the first time EQUIP is run in a
transaction directory.
Ignore this step if EQUIP has already been executed from the current
directory.
a - The first time EQUIP is run from any transaction directory, you
are prompted to create new database files. Answer Yes to this prompt by
typing <Y> and pressing the <ENTER> key. The EQUIP program will create
the required transaction files.
b - After the database files have been created, EQUIP then prompts you
to enter a Site ID name. BrightWorks uses the Site ID name to determine
your workstation's location.
For example, enter the file server name as the Site ID. To do this,
type:
(file server name) <ENTER>
where (file server name) is the name of your file server.
Upon pressing <ENTER>, EQUIP gathers the hardware and software
information from the workstation.
NOTE: Follow Steps #1-4 for each networked PC you want to inventory, or
call an EQUIP batch file from your system login script to automate
inventorying of networked PCs.
4.2.2 Configuring the Audit Parameters
Several audit parameters must be defined before performing an audit of the
collected inventory data. All audit configuration information is defined
from within the BrightWorks console.
The audit parameters that are defined in this step of the tutorial include:
o Audit scope - the sites and file servers to be audited
o Audited components - the inventory components to be audited
(e.g., hardware, software or both)
Use the following procedure to configure the audit parameters for this
tutorial.
1. Choose the Inventory command from the Administration menu. From the
sub-menu that displays, choose the Scope of Audit command.
The Scope of Audit dialog box displays, allowing you to select
the sites and file servers to be included in the audit.
To include a site or file server in the audit, click on the item name in
the corresponding left list box, and then choose the Include button. The
item name is moved into the list box on the right.
To remove a site or file server from the audit, click on the item name in
the corresponding right list box, and then choose the Remove button.
The item name is moved into the list box on the left.
2. For this tutorial, include both the local site in the audit scope
(i.e., the site that was created in the "Collecting Inventory
Data" step of this tutorial) and the file server on which BrightWorks
is installed.
NOTE: The Scope of Audit dialog box lists all file servers on the networ, but
only those file servers with BrightWorks installed can be audited, even if
the file server name is "included" in the Scope of Audit.
3. Choose the OK button to accept the audit scope definition.
When a file server is included in the scope definition, a Server
dialog box displays prompting you to enter your login name and password.
4. In the Server dialog box, enter your login name and password for the
selected file server, and then choose the OK button.
NOTE: You must have Supervisor rights or equivalent to include a file
server in the audit scope.
The configuration changes are saved, and the Scope of Audit dialog boxes
are closed.
5. To define what to audit and when to audit, choose the Inventory command
from the Administration menu. From the sub-menu which displays, choose
the Audit Parameters command.
The Audit Parameters dialog box displays with the three sections: What
to Audit, When to Audit, and Additional Options.
6. For this tutorial, check the following audit parameters:
o What to Audit: PC Software and PC Hardware
o What to Audit: Fileserver Software and Fileserver Hardware
o When to Audit: When Requested
Once these options are selected, choose the OK button to accept the audit parameters and close the
dialog box.
NOTE: Chapter 13 of this manual discusses the audit configuration procedures
in detail.
4.2.3 Running the Audit
Conducting an audit compiles the collected equipment inventory data from
your workstations and file servers and adds it to BrightWorks' baseline
inventory. Performing an audit updates the baseline inventory file to
represent an accumulation of your most currently audited inventory
information. The baseline inventory file provides data for various
BrightWorks inventory reports, on-screen viewing, automatic notification of
inventory changes, and the BrightWorks software distribution capability.
The audit process uses the currently defined audit parameters. Therefore,
before you initiate an audit, you should verify that the audit parameters
are set properly. (In the previous step of this tutorial, the audit scope
was defined to include the local BrightWorks site.)
Use the following procedure to perform an audit.
1. Choose the Inventory command from the Administration menu. From the
sub-menu that displays, choose the Audit command.
A message displays informing you that the baseline inventory will be
updated as a result of the audit. In order to maintain only the most
current inventory data, the baseline files are always updated by
performing an audit.
2. Choose the OK button to start the audit.
The Audit in Progress dialog box displays while the audit is running.
When the audit is complete, the Audit in Progress dialog box closes and
the baseline is updated to reflect the new inventory data.
NOTE: Chapter 15 of this manual discusses the audit process in detail.
4.2.4 Viewing Audit Results
As a result of performing an audit, BrightWorks' equipment and inventory
files are updated and are available for viewing.
The audit results that are viewed in this step of the tutorial include:
o Audit log - a list of all audits with access to audit summary and
detail information
o Inventory - a list of component data for PC/MAC workstations and
file servers
Use the following procedure to view the audit log and inventory details.
1. To view the Audit Log, choose the Inventory command from the
Administration menu. From the sub-menu which displays, choose the
View Audit Log command.
The Audit Log dialog box displays with a list of all the audits that
have been performed. The Date, Time, Performed By, and Status
information are listed for each audit.
2. To view the summarized results of an audit, select the audit from the
Audit Log dialog box and choose the Results button.
The Audit Results dialog box displays and lists the summarized results
of the selected audit.
Choose the Close button to close the Audit Results dialog box.
NOTE: The above audit log results dialog box can also be displayed by
double clicking on an audit in the Audit Log dialog box.
3. To view the details of an audit, select the audit from the Audit Log
dialog box and choose the Details button.
An Audit Details dialog box displays which contains an itemized list of
audited components, nodes, and system files.
Use the scroll buttons and scroll bars to view all the information.
Choose the Close button to close the Audit Details dialog box.
4. To view the inventory of your PC/MAC workstations and file servers,
choose the Inventory tool bar button.
The Inventory dialog box displays and lists the workstations and file
servers for each audited site. Use the scroll buttons to view all the
information.
5. Double click on a workstation type entry.
The detailed inventory data for the workstation displays in an inventory
details dialog. Use the slide bars and arrows to view the information
on the inventory screen.
The table below briefly lists the detailed inventory data displayed for
PC and MAC workstations. A complete list of the detected equipment
is provided in Chapter 31.
PC WORKSTATION MAC WORKSTATION
Computer Information Computer Information
Mass Storage Floppy Drives
Keyboard/Display Monitor Type
Ports Slot Adapters and Drivers
Network Adapter Mounted Volumes
Memory
6. View additional component data regarding the workstation by choosing the
Software Applications, Misc Equipment, System Files, and Notes buttons.
The corresponding dialog boxes provide detailed information regarding the
selected workstation.
NOTE: You can also view the Software Applications, Miscellaneous Equipment,
and Notes associated with a file server.
When you have finished viewing the information for the workstation,
choose the OK button to return to the View Inventory dialog box.
Choose the Close button to close the View Inventory dialog box.
NOTE: Chapters 16 and 17 of this manual discuss reviewing audit results
in detail.
This completes the inventory tutorial. All of the features introduced here
are described in full detail in Inventry.txt of this manual.
4.3 Distribution Tutorial
This tutorial outlines the major steps in using BrightWorks to distribute
software and scripts throughout your local area network.
NOTE: BrightWorks' distribution component must be installed on your
network before beginning the tutorial. If you have not already done so,
please refer to Chapter 2 for installation instructions.
The steps in this tutorial include the following:
1. Creating and Compiling a Script
2. Creating a Scope
3. Scheduling a Package for Distribution
4. Running the SDUPDATE.EXE Program at the Receiving Workstation
NOTE: The options and features mentioned in this tutorial are discussed in
detail in Distrib.txt of this manual.
You will realize the following benefits by using the BrightWorks distribution
capability on your network:
o Automate the distribution of system files, data files and software
applications to eliminate "sneaker-ware" for these functions
o Customize the distribution of system files, data files and software
applications using a flexible and powerful scripting language
o Edit system files (e.g., CONFIG.SYS, AUTOEXEC.BAT) to enable global
replacement and workstation-specific changes without having to visit each
workstation
4.3.1 Creating and Compiling a Script
A script is a series of commands to be executed on a remote workstation.
Scripts can be as simple as displaying a message on a remote user's monitor,
or they can be as complex as restructuring a hard drive and/or installing
and configuring software.
Use the following procedure to create a script.
1. Choose the Scripts command from the Tools menu.
The Scripts dialog box displays. For each script you define, the last
compilation date, the status and the file name will display.
2. Choose the New button.
The Open New Script dialog box displays prompting you to enter the name,
file name and destination directory for the new script.
3. Enter the new script information, and choose the OK button.
Enter a script name (up to 80 characters). All typed characters are valid.
The script name is used within BrightWorks for identifying the script.
Enter a script file name which must follow the standard DOS conventions
and can reside in any directory. The script file name is used to contain
the actual script commands.
NOTE: It is recommended that .SCR be assigned as the extension for all script
file names.
Upon choosing OK, the message "This file does not exist. Create the
file?" displays. Choose the Yes button to create the script file.
The Script editor window automatically displays so you can enter the
script. The script name being edited displays in the title bar of the
script editor dialog box.
4. Type the script commands.
Script commands can be directly typed into the script editor dialog box.
The script commands can also be selected from a list of commands by
choosing the Paste Script Function command from the BrightWorks Edit
menu or the Functions button.
The script compiler requires one command per line. No error checking is
performed until the script is compiled. Standard editing functions are
available from the Edit menu on the BrightWorks menu bar.
For the purpose of this tutorial, enter the following script command:
WRITELN "HELLO WORLD!"
The WRITELN script function is used to write a value (in this case,
"Hello World") to the screen at the receiving workstation.
NOTE: The commands and rules for using the scripting language are
documented in Chapter 22 of this manual, "Software Distribution Script
Language."
5. Save the script contents by choosing the Save button in the Script
Editor dialog box.
The script is saved and the editor window remains open. The saved
script contents are stored in ASCII text format.
Scripts must be compiled before they can be used in a package. Continue
with the following steps to compile the script.
6. Choose the Compile button in the Script Editor dialog box.
While a compile is in progress, the Compile Status dialog box displays.
When the compile is complete, the Status field in the Compile Status
dialog box indicates success or failure. If the compile fails, the
Function field indicates the first function found with invalid
parameters. The Statistics area indicates the total number of lines in
the script (Lines field) and the number of errors found (Errors field).
If you entered the script command exactly as shown in Step #5 above,
your script should compile successfully.
7. Choose the OK button in the Compile Status dialog box to continue.
The Compile Status dialog box closes.
8. Choose the Close button in the Script Editor dialog box to return to
the Scripts dialog box.
The script's status displays as COMPILED. A script can be used in a
package only after it has been compiled successfully.
9. Choose the Close button in the Scripts window.
4.3.2 Creating a Scope
A scope is a group of workstations defined to receive a distributed package.
Any number of workstations can be included in a scope definition.
Use the following procedure to create a new scope.
1. Choose the Scopes command from the Tools menu.
The Scopes dialog box displays.
2. Choose the New button.
The New Scope dialog box displays prompting you to enter a name for
the new scope.
3. Enter the new scope name, and choose the OK button.
A scope name can be up to 80 characters, and all typed characters are
valid. For example, enter the new scope name "TUTORIAL_SCOPE."
Upon choosing OK, the Edit Scope dialog box displays prompting you to
define the new scope.
The Edit Scope dialog box consists of two lists:
o Nodes in SITE - the list on the left side of the dialog box
consists of all node names that apply to the local site. The site
name is indicated by the SITE text in the list title. The nodes in
this list are not included in the selected scope
(i.e., the list to the right).
o Nodes included in Scope - the list on the right side of the
dialog box consists of the nodes that are in the selected scope.
NOTE: The Query Options section of the Edit Scope dialog box is used to
perform a query to filter the node names in the Nodes in SITE list. This
procedure is discussed in detail in Chapter 23 of this manual.
4. Define one node to be included in the scope.
Use the push buttons in the center of the Edit Scope dialog box to
define the scope members. To define scope membership, select a node
name from the Nodes in SITE list and choose the Include >> button.
The selected node name moves from the left list to the Nodes Included
in Scope list.
5. Choose the Save button.
The scope's membership is defined, and you are returned to the Scopes
dialog box.
6. Choose the Close button to close the Scopes dialog box.
4.3.3 Scheduling a Package
Software is distributed across your local area network by creating and
activating a package. When a package is created, it is assigned a scope and
a "Start Date." Upon reaching the start date and running the SDUPDATE.EXE
program at a workstation in the scope, an active package automatically gets
sent to the workstation.
Use the following procedure to schedule a package consisting of the scope
and script created in this tutorial.
1. Choose the Packages command from the Tools menu, or choose the
Distribute tool bar button.
The Packages dialog box displays with the names and status information
of all defined packages.
2. Choose the New button in the Packages window.
The New Package dialog box displays prompting you to enter a name for the
new package.
3. Enter the new package name, and choose the OK button.
The package name can be up to 80 characters, and all typed characters are
valid.
Upon choosing OK, a New Package dialog box displays. The name of the
new package is indicated in the title bar of the dialog box.
4. Select a script to be included in the package.
Choose the down arrow button to the right of the Update Fileset and/or
Update Script fields to display the list of existing filesets and scripts.
From the drop-down list, select the script that was created during this
tutorial.
NOTE: A package must include a fileset and/or a script.
5. Select the scope to receive the package.
Choose the down arrow button to the right of the Update Scope field to
display the list of existing scopes. From the drop-down list, select the
scope that was created during this tutorial.
NOTE: A scope must be assigned to the package. The scope must have at
least one member.
6. Assign the package's Start Date.
Enter the date on which the package is to be distributed. Use the
current date which appears as a default in this field.
7. Assign the Active status to the package.
Check the "Update active when saved" option to automatically place the
package in an active state upon saving the package. (An active package
will get distributed automatically on its assigned start date.)
If this field is not checked, an Inactive status will be assigned to
the package. An inactive package will not get distributed automatically
on its assigned start date.
8. Specify the package's update option.
The selected Update Option instructs the software distribution update
program how it should interact with the receiving workstation user at
login time.
For this tutorial, select the 'Force upgrade at next login' option to
force the package's receipt on the user at the next login. If an error
occurs, the distribution is halted so you can address the problem and
reschedule the package.
9. Specify the target path in which the fileset should be decompressed.
Even though this package does not consist of a fileset, a default path
must be assigned to the package. The default path is the target path in
which the distributed software (e.g., fileset) is to be installed or
copied.
For this tutorial, enter the default path as the workstation's boot root
(i.e., choose the [BOOT_ROOT] option).
10. When all package attributes are defined, choose the Save button.
The New Package dialog box closes, and the package is saved and
assigned an active status.
4.3.4 Running the Update Program
The distribution update program (SDUPDATE.EXE) is a DOS-based program
which must be run from each workstation in order to receive the distributed
packages it has been sent. Upon BrightWorks installation, the update
program is copied into the BWORKS program directory.
SDUPDATE [drive:[\path]]
in which drive and path are optional parameters. The brackets are not typed.
Consider the following examples:
Example Result
SDUPDATE SDUPDATE will look in the current directory.
SDUPDATE F: SDUPDATE will look in the current
directory on drive F:.
SDUPDATE F:\path SDUPDATE will look in the directory F:\path.
Use the following procedure to run the update program and distribute the
active package.
1. At the workstation which is to receive the distributed package,
load the Btrieve Record Manager.
Either Btrieve or Brequest can be used. Refer to section 12.6.3 entitled
"Consider Improving BrightWorks' Database Performance" for more
information about the Btrieve database.
2. Make the BWORKS directory your current directory.
Use the DOS CD command to change into the BWORKS program directory,
or map a physical drive to the BWORKS directory.
3. Execute the SDUPDATE.EXE program.
For example, enter the following at the DOS command line:
SDUPDATE
Upon executing SDUPDATE, messages similar to the following will
display at your workstation:
Looking for packages, please wait...
Installing package "TUTORIAL"...
Created target path.
Target path: C:\
Disk space: ### bytes free
Running Script "HELLO_WORLD"...
HELLO WORLD!
The script completed successfully.
No more packages scheduled.
This completes the distribution tutorial. All of the features introduced
here are described in full detail in Distrib.txt of this manual.